home *** CD-ROM | disk | FTP | other *** search
/ TPUG - Toronto PET Users Group / TPUG Users Group CD / TPUG Users Group CD.iso / AMIGA / (A)TB / (A)TBX.ADF / WB2.0 / NickPrefs / NickPrefs.doc < prev    next >
Text File  |  1992-03-19  |  8KB  |  193 lines
  1.                                  NickPrefs
  2.  
  3. The files in this archive were written by Nicola Salmoria and are
  4. freely distributable as long as the archive remains intact, and only
  5. a nominal fee is charged for its distribution.
  6.  
  7. This software is provided "AS IS" without warranty of any kind,
  8. either expressed or implied. By using it, you agree to accept the
  9. entire risk as to the quality and performance of the program.
  10.  
  11. Comments, suggestions and bug reports are welcome.
  12.  
  13.    Nicola Salmoria
  14.    Via Piemonte 11
  15.    53100 Siena   ITALY
  16.  
  17.  
  18. Overview
  19. --------
  20. NickPrefs is an enhancement of IPrefs, the preferences manager of
  21. Workbench 2.0. From these very few words, you understand that you
  22. need Kickstart 2.0 to use this program ;-) It has been tested under
  23. Kickstart 2.04, that is the one burnt in the A500+' ROMs.
  24.  
  25. NickPrefs manages three new preferences, which may be modified with
  26. the three accompaning programs WBPicture, BusyPointer and Floppy.
  27. WBPicture allows you to display any IFF picture in the main Workbench
  28. window, supplanting the original (and boring ;-)) WBPattern.
  29. BusyPointer lets you edit the clock pointer used by programs when
  30. they are busy. You may create an animated pointer, see later for
  31. details.
  32. Floppy provides the ability to mess with the public fields of track-
  33. disk, that is the TDPF_NOCLICK flag, step delay and the like. BE
  34. CAREFUL when changing the delays! You should not touch them unless
  35. you really know what you're doing! Read on for more info.
  36.  
  37.  
  38. Installation
  39. ------------
  40. Copy Nickprefs in your C: directory, and edit s:startup-sequence.
  41. Search for the line "IPrefs", and below it write "NickPrefs". It's
  42. important to launch NickPrefs just after IPrefs.
  43. If you are currently using my program "BusyPointer" or a similar (and
  44. less powerful ;-)) busy pointer animator, remove it from the startup-
  45. sequence since NickPrefs replaces it.
  46. Likewise, if you use a program that turns off the drive click remove
  47. it because Floppy does the same thing and much more.
  48.  
  49. Then copy WBPicture, BusyPointer and Floppy in SYS:Prefs, and reset.
  50. You're now ready to go.
  51.  
  52.  
  53. WBPicture
  54. ---------
  55. I've tried to make WBPicture, BusyPointer and Floppy identical to the
  56. other Preferences, so usage is (or should be) exactly the same.
  57. When started the first time, WBPicture will open a window with most
  58. gadgets disabled. Click on the "Name" gadget to pick a filename, or
  59. just insert it in the string gadget. Pay attention to specify a
  60. complete path for the picture, e.g. "PICTURES:foo". Do not use a
  61. relative path or NickPrefs won't be able to locate the file. Note
  62. that the file is referenced by name, not stored in the preferences
  63. file, so you must provide a path which is always accessible at boot
  64. time (that is, somewhere in the hard disk, or your boot floppy).
  65.  
  66. When you've selected a picture, its size, planes and aspect ratio are
  67. displayed. On their right are the current settings of the Workbench
  68. screen, so you can compare them.
  69.  
  70. Below the info fields there are two checkbox. You can decide to
  71. center the picture in the screen, or to put it in the top left
  72. corner. If you are using a small brush, it can be tiled to cover the
  73. whole screen. Try with "Boing.br" contained in the "Presets"
  74. directory of this archive.
  75.  
  76. Then there is a gadget named "Load Palette". It will call the Palette
  77. Preferences loaded with the image's palette. You may then decide to
  78. use that colors, if they don't mess the 3D look of Workbench, or to
  79. keep the old colors. Pictures are *NOT* remapped to suit the actual
  80. Workbench palette, so if you have an image processor, you may want to
  81. use it. I use an 8 color Workbench, with this palette:
  82.   10 10 10  grey
  83.    0  0  0  black
  84.   15 15 15  white
  85.    6  8 11  blue
  86.    9  6  3  brown
  87.    3  8  3  green
  88.   12 12  0  yellow
  89.   14  7  0  orange
  90.  
  91. Reducing a picture from HAM to 8 colors with this palette, using some
  92. kind of dithering (and of course resizing it) often gives good
  93. results.
  94.  
  95. Finally, the "Test" gadget is equivalent to the one in WBPattern, and
  96. lets you see what the background looks like without exiting from
  97. WBPicture.
  98.  
  99.  
  100. BusyPointer
  101. -----------
  102. This is a replacement for my former program, "BusyPointer".Just as
  103. Pointer allows you to edit the Intuition pointer, this one gives you
  104. the possibility to edit the clock which the Workbench and other
  105. programs show when busy.
  106. But it does more than that: if you activate the "Guess Busy" option,
  107. not only the standard clock but also bubbles, "Wait" writings and the
  108. like will be converted to the one you chose. The option does exactly
  109. what it says: it will try to "guess" if a pointer represents a busy
  110. state or not. The algorithm is rather complex, and may fail. It works
  111. nice with most programs, but may turn to busy some pointers it
  112. shouldn't, or vice versa. Please let me know of such behaviours.
  113.  
  114. The editor is very similar to Pointer, but you can create animations.
  115. Just write the number of frames you want and use the slider to move
  116. across them.
  117.  
  118. The program has the capability to import IFF brushes and animbrushes.
  119. This is obtained selecting "Open..." in the menu "Project", like when
  120. you load a saved preset. If you have animations written for the
  121. stand-alone version of BusyPointer, you can load them as well.
  122. Animations replace the current one; if you load a single brush, it
  123. replaces only the current frame.
  124.  
  125. There are four presets provided with this archive; they are:
  126. - StopWatch  the standard clock, animated
  127. - TwoHands   the standard clock with two spinning hands
  128. - SandGlass  a sandglass
  129. - ZZBubble   the Workbench 1.3 bubble
  130.  
  131.  
  132. Floppy
  133. ------
  134. This one lets you stop that annoying drive click, and also mess with
  135. step, settle and calibrate delay. Parameters are set individually for
  136. each drive.
  137.  
  138. Normally, you should not touch the delay sliders. The default values,
  139. 3000, 15000 and 4000 ╡s, are the lower bounds stated by Commodore for
  140. the drive mechanics. Lowering them, the drive may work anyway, but
  141. don't expect to speed up floppy access, so there's no point in doing
  142. that. If you own an out of specs drive, raising step and calibrate
  143. delay may reduce the risk of r/w errors.
  144.  
  145. Note that the step delay greatly affects the noise the heads make
  146. while moving. If your drive is particularly noisy, you may try to
  147. make it more bearable by fine tuning the step delay.
  148.  
  149. The "Max Retry" slider shows the number of times that the trackdisk.-
  150. device retries to read a track when it finds an error. This is quite
  151. interesting, for two reasons:
  152. - Lowering it to zero will cause a read error request to pop up
  153.   immediately, without retrying to read the track. This means that
  154.   you will discover earlier potential fatal errors due to
  155.   imperfections in the disk.
  156. - Raising it will increase the chance to read a faulty track, al-
  157.   lowing to recover data. Copy it somewhere else and throw away the
  158.   disk!
  159.  
  160. I am currently using a Max Retry of 0 times, and I've no problems at
  161. all.
  162.  
  163.  
  164. Bugs
  165. ----
  166. I have problems in recognizing the main Workbench window from drawer
  167. windows. Currently, I modify the BackFill Hook if the window has the
  168. flag WFLG_WBENCHWINDOW set and: is a backdrop window or its title is
  169. "Workbench". This means that if you open a drawer whose name is
  170. "Workbench", its hook will be mistakenly changed.
  171. You can easily work around this bug simply by changing the drawer's
  172. name: since the patch is case sensitive, you may call it "WorkBench"
  173. (note the capital 'B').
  174.  
  175. If the color map of a picture is in 24-bit format, instead of the
  176. usual 12-bit, Palette does not read it correctly. This is a bug in
  177. Palette, *NOT* in WBPicture. I hope it will be fixed soon.
  178.  
  179.  
  180. Acknowledgments
  181. ---------------
  182. As usual, I have to thank my beta testers, whose help has been
  183. invaluable during the development of this program:
  184.  
  185. Stefano Iacus
  186. Federico Giannici
  187.  
  188. Many thanks to Dante Profeta who provided me the documentation for
  189. the IFF ANIM format, without which I wouldn't have been able to load
  190. animbrushes from BusyPointer.
  191.  
  192. Thank you very much!
  193.